This simple file viewer lets you quickly inspect text files, binary files (in filtered form) and specially formatted files known as <a href="#POMMELDO">Pommel</a> documents. (The file you are looking at right now is an example of a Pommel document.)
<a name="BASICUSA"><h1>Basic Usage</h1>
<a name="SHORTCUT"><h2>Shortcut Keys</h2>
In addition to standard shortcut conventions (such as pressing Alt-F to click the Find button) the file viewer also recognizes these keys:
<hl> Home Move cursor to start of line</hl>
<hl> End Move cursor to end of line</hl>
<hl> Space Advance one screen (same as PgDn)</hl>
<hl> Esc Close window</hl>
<hl> Enter If view area has focus: repeat last find</hl>
<hl> Otherwise: operates the control</hl>
<hl> Ctrl-Home Jump to top of file</hl>
<hl> Ctrl-End Jump to end of file</hl>
<hl> Ctrl-C Copy selected text to clipboard</hl>
<hl> F1 Display help (this file)</hl>
<hl> F3 Repeat last find</hl>
<hl> F5 </hl><a href="#DETFILUP">Check file</a><hl> for updates</hl>
<hl> Backspace </hl><a href="#BACKTRAC">Backtrack</a><hl> to previous spot</hl>
<hl> F Pop up Find window</hl>
<hl> R Repeat last find</hl>
<hl> P Print</hl>
<hl> B Turn on </hl><a href="#BINFILNS">binary file noise suppression</a>
<hl> G Goto line number</hl>
<hl> W Toggle <a href="#WORDWRA">word wrapping</a></hl>
Note: You can click on any text highlighted in blue to jump directly to the appropriate section.
<a name="STATUSBA"><h2>The Status Bar</h2>
The status bar appears at the bottom of the file viewer window and is divided into three sections.
The first section of the status bar indicates the line number and character number of your cursor. For example, 34:3 means "line 34, column 3".
If you select a range of characters for cutting and pasting, the length of the selection (including Carriage Return and Linefeed characters) is also indicated. For example, 10:5/15 means that you have selected 15 characters, starting at the 5th character of line 10.
The second section of the status bar may contain letters, which indicate which features have been turned on, as follows:
<hl> B </hl><a href="#BINFILNS">Binary file noise suppression</a><hl> is on</hl>
<hl> W </hl><a href="#WORDWRA">Word wrapping</a><hl> is on</hl>
The third section of the status bar lists the total number of lines available for display, followed by the date and time when the file was saved. If there was insufficient room to load all of the file, or if you interrupted loading by pressing the Esc (Escape) key, the word "incomplete" appears after the line count.
<a name="WORDWRA"><h2>Word Wrapping and Display Width</h2>
Word wrapping can be turned on and off with the W key.
If word-wrap is turned on (W appears in the <a href="#STATUSBA">status bar</a>), words are wrapped according to the line length indicated by the "Display width" combo box. This does not affect the file being viewed.
If word-wrap is turned off, any lines that are longer than the value of the "Display width" combo box are wrapped at that specific length. This does not affect the file being viewed.
<a name="PRINTING"><h2>Printing</h2>
This simple file viewer offers only very basic printing capability. You can print the file you are viewing, in its entirety, using the current settings of your default printer. This file viewer makes no provision for changing settings such as feeder drawer, paper type or orientation.
Margins are set to 1 inch on the left and right, and three quarters of an inch top and bottom. Different printers behave in different ways if asked to print text wider than the width available; some truncate the text and some word-wrap it. You can accomodate this variation to some extent by adjusting the "Display Width" combo box.
To print a copy of this document, press the P key.
Binary file noise suppression can be turned on and off with the B key.
When binary file noise suppression is turned on (B appears in the <a href="#STATUSBA">status bar</a>), the file viewer attempts to display only data that looks like it might be text. Anything else is considered raw binary data and is represented by dot characters.
If the file you are viewing has been changed in another window, you can reload it by pressing F5. (Some applications that use this file viewer detect such changes automatically under certain conditions.)
When the file is reloaded, the file viewer attempts to reposition you at the same spot you were viewing previously. However, depending on how the file was changed, it may not be possible to reposition your view precisely.
<a name="BACKTRAC"><h2>Backtracking</h2>
When you do a "Find" (or click a link in <a href="#POMMELDO">Pommel</a> documents), the file viewer remembers where you were before jumping to the new location. When you press Backspace you return to the previous spot. The file viewer remembers up to 50 previous locations.
</fs>The file viewer can process HTML-like files known as POMMEL<fs x="1.5">™</fs> documents. This feature must be explicitly turned on by the application that calls the file viewer, so it should not adversely affect the display of any files you inspect.
In text files, long lines may be <a href="#WORDWRA">wrapped</a> in the display area. This does not affect the file itself. You can use the "Display width" combo box to choose a line length which makes the file convenient to view.
When binary files are viewed, any character with a hexadecimal value between $00 and $1F is replaced by a dot character. This does not affect the file itself.
The file viewer has a limit on the size of the file it can load. If it should run out of room, it will truncate the file display and mark it as "incomplete" in the <a href="#STATUSBA">status bar</a>. This does not affect the file itself.
